Session de terminal (Terminal Session)

UiPath.Terminal.Activities.TerminalSession

Conteneur qui se connecte à un terminal et vous permet d'y effectuer plusieurs actions. Une fois l'activité glissée dans le concepteur de workflow, la fenêtre Configurer la connexion (Configure Connection) s'ouvre. S'il est fermé, il peut être rouvert à l'aide du bouton Configurer la connexion... dans le corps de l'activité.

Une fois la connexion établie, le bouton Démarrer l'enregistreur ( Start Recorder ) peut être utilisé pour se connecter au terminal et enregistrer les actions nécessaires. Le bouton est placé dans le corps de l’activité.

Propriétés

Commun

• Continue On Error : indique si l'automatisation doit se poursuivre, même lorsque l'activité génère une erreur. Ce champ ne prend en charge que des valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si la valeur est définie sur True, l'exécution du projet se poursuit indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur (Continue On Error) est vraie, aucune erreur ne sera détectée lors de l'exécution du projet.
• NomAffichage (DisplayName) - Nom affiché de l'activité.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Nouvelle session

• Chaîne de connexion ( Connection String) - Chaîne qui contient les détails de connexion. Ce champ ne prend en charge que les chaînes et les variables String .
• Connexion de sortie ( Output Connection) - La connexion établie est stockée dans une variable TerminalSession . Cette variable peut être transmise aux autres activités Session du terminal ( Terminal Session ) dans le champ de propriété Connexion existante ( Existing Connection ) si vous souhaitez réutiliser la connexion déjà établie. Ce champ prend uniquement en charge les variables TerminalSession .

Options

• DelayMS : délai (en millisecondes) avant que l'activité ne commence à effectuer des opérations. La valeur par défaut est de 1000 millisecondes (1 seconde).
• TimeoutMS (TimeoutMS) - Spécifie la durée (en millisecondes) à attendre pour que l'activité s'exécute avant qu'une erreur soit générée. La valeur par défaut est de 50 000 millisecondes (50 secondes).

Propriétés de la connexion SSH

• Mot depasse SSH : le mot de passe SecureShell utilisé pour se connecter au terminal spécifié, stocké dans une variable SecureString . Ce champ ne prend en charge que SecureString variables.
• Nom d'utilisateur SSH : le nom d'utilisateur SecureShell utilisé pour se connecter au terminal spécifié, stocké dans une variable String . Ce champ prend uniquement en charge les chaînes et les String variables.

Utiliser la connexion existante

• Fermer la connexion ( Close Connection) - Si cette case est cochée, la connexion existante est fermée après l'arrêt de l'exécution de l'activité. Par défaut, cette case est cochée. Notez que cette propriété est ignorée si la propriété Connexion de sortieest définie.
• Connexion existante ( Existing Connection) - L'indication d'une variable TerminalSession dans ce champ de propriété utilise la connexion stockée dans la variable pour se connecter à un terminal. Ce champ prend uniquement en charge les variables TerminalSession .

La fenêtre Configurer la connexion

La fenêtre Configurer la connexion (Configure Connection) contient diverses options de configuration qui varient en fonction du type de fournisseur choisi pour établir la connexion à l'environnement de terminal.

Propriétés indépendantes du fournisseur choisi :

• Afficher l'application cliente ( Show Client Application ) - Si cette option est cochée, affiche une vue de l'écran du terminal au moment de l'exécution.

Le fournisseur de connexion directe

Le fournisseur de connexion directe est un fournisseur interne UiPath qui n'a besoin d'aucun logiciel d'émulation de terminal tiers sur la machine robot. L'émulation est effectuée par le robot, au moment de l'exécution.

Propriétés de configuration :

• Adresse (Address) - Adresse IP ou nom d'hôte du système d'environnement du terminal.
• Port - Numéro de port où le système d'environnement du terminal accepte les connexions.

• Type (Type) - Type d'émulation de terminal nécessaire :

  • TN3270 - Couramment utilisé par les systèmes IBM de la série Z
  • TN5250 - Couramment utilisé par les systèmes IBM de la série I (AS-400)
  • VT - Terminaux compatibles DEC VT
  • Série HP - Émulation de terminal spécifique à HP
  • Tandem - Émulation de terminal système Tandem
  • guide - Émulation de terminal de la série Cyberse
  • ANSI - Émulation de terminal basée sur la spécification ANSI
  • Scénario ANSI : extension de la spécification ANSI utilisée par les systèmes SCO Unix

• Protocole (Protocole) - Protocole de communication à utiliser pour la connexion :

  • telnet - Le protocole telnet
  • SSH : le protocole SSH utilisé par la plupart des systèmes Unix/Linux.
  • HPVT - Protocole spécifique à HP utilisé en conjonction avec l'émulation de terminal série HP
• Mode terminal ( Terminal Mode ) - Version spécifique de l'émulation de terminal. La valeur disponible ici dépend de la valeur choisie dans le champ Type.
• Encodage (Encoding) - Page de code utilisée par le système d'environnement du terminal. La valeur par défaut est IBM037 pour les terminaux de la famille IBM et ASCII pour les autres types de terminaux.
• Activer SSL/TLS : utilisé conjointement avec le protocole telnet, pour spécifier que le système d'environnement du terminal utilise une connexion chiffrée SSL ou TLS.
• Nom LU : le nom de l'unité logique, utilisé avec les types de terminaux de la famille IBM.
• Réponse : un message texte à envoyer au système hôte lorsque le terminal reçoit le caractère de commande ENQ . Le message peut contenir la touche de contrôle Entrée, encodée dans la valeur de chaîne sous la forme ^M. Cette option de configuration est disponible uniquement lorsque le type de terminal sélectionné est VT.

Le fournisseur IBM EHLLAPI

Le fournisseur IBM EHLLAPI fonctionne avec n'importe quel logiciel d'émulation de terminal tiers qui implémente l'API EHLL. Les détails de l'implémentation de l'API EHLL doivent être trouvés dans la documentation du logiciel d'émulateur de terminal tiers.

Remarque : le logiciel d'émulation de terminal doit être démarré et connecté avant de tenter de s'y connecter via EHLLAPI.

Propriétés de configuration :

• DLL EHLL : chemin d'accès à la DLL utilisée pour implémenter l'APIEHLLAPI dans le logiciel émulateur de terminal tiers.
• Fonction EHLL : le nom de la fonction du point d'entrée dans la DLL EHLL. Généralement, « hlapi ».
• Session EHLL ( EHLL session) - Nom de la session tel qu'il apparaît dans le logiciel d'émulation du terminal. Habituellement « A », mais lors de l’utilisation de plusieurs sessions simultanées, la valeur peut varier.
• Encodage EHLL ( EHLL encoding ) : l'encodage utilisé par le logiciel d'émulation de terminal pour la connexion donnée.
• EHLL amélioré : utilisé pour spécifier si l'émulateur de terminal tiers implémente la version standard ou améliorée de l'API EHLL.
• Encodage (Encoding) - Page de code utilisée par le système d'environnement du terminal. La valeur par défaut est IBM037 pour les terminaux de la famille IBM et ASCII pour les autres types de terminaux.
• Mode basique ( Basic mode ) - Un mode qui désactive le traitement au niveau du champ pour de meilleures performances. Notez que les activités au niveau du champ (Get Field, Set Field, etc.) ne fonctionneront pas dans ce mode.
• Exécuter dans le processus (Run in process ) - Contrôle la façon dont la communication avec l'émulation du terminal tiers est effectuée via l'API EHLL. Par défaut, cette option est désactivéeet, dans ce cas, la communication s'effectue via un processus proxy, un exécutable différent qui fait partie du package d'activités du terminal. Lors de l'exécution, le processus proxy communique avec le processus exécuteur UiPath via IPC ( communication inter-processus). Lorsqu'elle est activée, la communication avec le logiciel d'émulation de terminal tiers s'effectue à l'intérieur du processus UiPath Executor. Cette option ne doit être activée que si le fonctionnement correct du processus proxy est impossible par un logiciel antivirus ou par des politiques de sécurité logicielle.

Remarque : En raison d'une limitation de la spécification de l' EHLLAPI, la version améliorée d'EHLLAPI ne prend pas en charge l'utilisation de plusieurs sessions EHLLAPI lorsque l'option Exécuter dans le processus (Run in process) est cochée. Seule l'implémentation standard d'EHLLAPI prend en charge un tel scénario. Cela signifie que l'option EHLL améliorée n'est pas cochée et que le fichier DLL répertorié dans le champ EHLL dll est une version qui implémente la spécification EHLLAPI standard.

Le fournisseur de réflexion Attachmate

Le fournisseur Attachmate Reflection fonctionne avec l’émulateur de terminal Attachmate Reflection.

Propriétés de configuration :

• Joindre à la session existante ( Attach to existing session ) - Dans ce mode, l'émulateur de terminal doit être déjà démarré et connecté. Aucun profil de configuration ne sera utilisé dans ce cas.
• Utiliser un profil existant (Use an existing profile ) : dans ce mode, le chemin d'accès à un profil de configuration doit être fourni. L'émulateur de terminal démarrera automatiquement.

• Spécifier manuellement l'adresse (Manually spécifiez l'adresse ) - Dans ce mode, aucun profil de configuration ne sera utilisé. Les propriétés de configuration doivent être spécifiées manuellement :

  • Adresse (Address) - Adresse IP ou nom d'hôte du système d'environnement du terminal
  • Port - Un numéro de port où le système d'environnement du terminal accepte les connexions

  • Type (Type) - Type d'émulation de terminal nécessaire :

    • TN3270
    • TN5250
    • VT

Le fournisseur Attachmate Extra

Le fournisseur Attachmate Extra fonctionne avec Attachmate Extra ! émulateur de terminal.

Propriétés de configuration :

• Utiliser un profil existant (Use an existing profile ) : un chemin d'accès vers un profil de configuration doit être fourni. L'émulateur de terminal démarrera automatiquement.

Le fournisseur Reflection for UNIX

Le fournisseur Reflection for UNIX fonctionne avec l'émulateur de terminal Reflection for Unix.

Propriétés de configuration :

• Utiliser un profil existant (Use an existing profile ) : un chemin d'accès vers un profil de configuration doit être fourni. L'émulateur de terminal démarrera automatiquement.

Le fournisseur de Reflection for IBM

Le fournisseur Reflection for IBM fonctionne avec l'émulateur de terminal Reflection for IBM.

Propriétés de configuration :

• Utiliser un profil existant (Use an existing profile ) : dans ce mode, le chemin d'accès à un profil de configuration doit être fourni. L'émulateur de terminal démarrera automatiquement.

• Spécifier manuellement l'adresse (Manually spécifiez l'adresse ) - Dans ce mode, aucun profil de configuration ne sera utilisé. Les propriétés de configuration doivent être spécifiées manuellement :

  • Adresse (Address) - Adresse IP ou nom d'hôte du système d'environnement du terminal
  • Port - Un numéro de port où le système d'environnement du terminal accepte les connexions

  • Type (Type) - Type d'émulation de terminal nécessaire :

    • TN3270
    • TN5250
    • VT

Le fournisseur de Rocket BlueZone

Le fournisseur Rocket BlueZone fonctionne avec l'émulateur de terminal Rocket BlueZone.

Propriétés de configuration :

• Utiliser un profil existant (Use an existing profile ) : dans ce mode, le chemin d'accès à un profil de configuration doit être fourni. L'émulateur de terminal démarrera automatiquement.

• Spécifier manuellement l'adresse (Manually spécifiez l'adresse ) - Dans ce mode, aucun profil de configuration ne sera utilisé. Les propriétés de configuration doivent être spécifiées manuellement :

  • Adresse (Address) - Adresse IP ou nom d'hôte du système d'environnement du terminal.
  • Port - Numéro de port où le système d'environnement du terminal accepte les connexions.

  • Type (Type) - Type d'émulation de terminal nécessaire :

    • TN3270
    • TN5250
    • VT

Le fournisseur IBM Personal Communications

Le fournisseur IBM Personal Communications fonctionne avec l'émulateur de terminal IBM Personal Communications.

Propriétés de configuration :

• Utiliser un profil existant (Use an existing profile ) : dans ce mode, le chemin d'accès à un profil de configuration doit être fourni. L'émulateur de terminal démarrera automatiquement.

Meilleures pratiques pour les activités de terminal

• Lorsque vous utilisez les propriétés Connexion de sortie (Output Connection)/Connexion existante (Existing Connection ), assurez-vous de fermer la session de terminal lorsqu'elle n'est plus nécessaire dans le workflow/processus. Laisser la session de terminal ouverte peut avoir des effets négatifs sur les performances et l'exécution des autres sessions de terminal. Pour fermer correctement une session de terminal précédemment enregistrée, ajoutez une nouvelle session de terminal (avec un corps vide) à votre workflow, avec les propriétés suivantes :
  • Fermer la connexion : Vrai
  • Connexion existante : la variable TerminalSession qui contient la session enregistrée
• Évitez d'utiliser les propriétés Connexion de sortie (Output Connection)/Connexion existante (Existing Connection ) conjointement avec le fournisseur IBM EHLLAPI . Ces options permettent de garantir la persistance de la connexion entre les workflows. Étant donné que la connexion est déjà conservée dans l'émulateur de terminal, une deuxième couche de persistance n'est pas nécessaire. Cela évite également d'avoir à effectuer les étapes supplémentaires pour fermer la connexion comme décrit ci-dessus.
• Évitez d'utiliser des sessions de terminal imbriquées dans d'autres sessions de terminal. Cela s'applique également à l'imbrication indirecte, telle que l'appel à partir d'un corps de session de terminal d'un workflow qui contient une session de terminal avec la même connexion, ou l'appel d'une fonction de bibliothèque qui contient une session de terminal avec la même connexion.
• Évitez d'utiliser des activités basées sur des champs telles que Get Field/Set Field. Il n'est pas toujours clair si l'écran est divisé en champs ou comment, ce qui peut prêter à confusion. De plus, différents fournisseurs peuvent diviser le même écran de différentes manières car différentes API sont utilisées. Il est plus sûr d'utiliser des méthodes similaires à celles utilisées par les humains, par exemple des combinaisons d'activités Déplacer le curseur ( Move Cursor ) ou Envoyer la touche de contrôle = Tab (Send Control Key = Tab) suivies d'activités Envoyer les touches ( Send Keys ) pour envoyer des données à l'écran. Pour récupérer les données à partir de l'écran, utilisez Obtenir la zone d'écran ou Obtenir le texte en position.
• Utilisez l’activité Attendre le texte de l’écran pour vous assurer que le bon écran a été chargé avant d’effectuer des opérations dessus
• Pour extraire des données tabulaires d'écrans au format DataTable, utilisez l'activité Get Screen Area pour la partie de l'écran contenant la table et utilisez la sortie de cette activité comme entrée pour l'activité Generate Data Table , à partir du package UiPath.System.Activities .